The contents of this scripting package (the “ClickPad II Scripting” scripting extension, the example scripts, and this “readme” file) are provided for free to registered users of ClickPad II. Permission to redistribute this package is granted, provided that (1) the entire scripting package is distributed intact and (2) the files are not modified.
Requirements
• PowerBook 520, 540, or 5300
• a registered copy of ClickPad II version 2.1 or 2.2.x
• AppleScript
Installation
Move the file “ClickPad II Scripting” into the Scripting Additions folder. This folder is located inside your extensions folder:
:System Folder:Extensions:Scripting Additions
If you don’t have this folder, then you probably don’t have AppleScript installed. Look on your system disks/CD or in the “Apple Extras” folder for the AppleScript installer. Install AppleScript and then move “ClickPad II Scripting” into the Scripting Additions folder.
That’s it!
Dictionary
You can get a list of the available commands and properties from the Script Editor by choosing “Open Dictionary...” and selecting the ClickPad II Scripting file.
In the current version, there are two commands:
get clickpad property
returns integer — value of property
set clickpad property to integer
returns boolean — true if the property was successfully changed
Except where noted, the only values for properties are 0 (off) and 1 (on).
The currently supported properties are:
active — ClickPad II is active (master switch)
make sounds — make clicking sounds
menus stick — menus stick when clicked
popups stick — pop-up menus stick (note: this cannot be turned on unless it was on at boot)
shorter clicks — shorter delay between start and end of clicks
drag pauses — drags do not terminate immediately when your finger is lifted, allowing you to put your finger back down and continue the drag
flash caps lock — indicator light (LED) on caps lock key is flashed when ClickPad is drag-locked. This feature is only supported by version 2.2 of ClickPad II, and only on machines that have the 5300 US keyboard.
volume — get/set the precise click volume. Acceptable values are 0 [silence] through 15 [maximum volume]. The normal sound level is 3, and the “louder” volume is 8. Note that this is not the machine sound volume, only the click sound volume.
finger movement — pixels of movement permissable during a tap. This feature is only supported by version 2.2 of ClickPad II. Acceptable values are 0 [no movement permitted] through 30. The default value is 3 (for version 2.2) or 5 (for version 2.1 and earlier, although it is not configurable in those versions). Values of zero, or greater than six, are not recommended for general use.
tap time — maximum duration, in 1/60ths of a second, of a tap. This feature is only supported by version 2.2 of Clickpad II. Acceptable values are 5 (1/12th of a second) to 30 (a half-second). It is difficult for most people to tap the TrackPad for less than 1/12th of a second.
intertap time — maximum duration, in 1/60ths of a second, between a tap and the start of the associated drag. This feature is only supported by version 2.2 of ClickPad II. Acceptable values are 5 (1/12th of a second) to 30 (a half-second).
Examples
The example scripts included in this package show how to use these commands to toggle various settings when run.
Ideas
• if multiple people use your PowerBook, and each prefers slightly different settings, you can set up scripts for each of them to quickly re-configure ClickPad II without having to bring up the control panel.
• [have other good ideas, or scripts you think other ClickPad II users would be interested in? Send them to me, and I'll make them available on the ClickPad II web site!]
Miscellaneous Notes
• changes made to settings via AppleScript are not written to the ClickPad II preferences file, so the current control panel settings will be restored at next startup. However, if you make changes via AppleScript, then open and close the ClickPad II control panels, the changes will be saved.
• this scripting extension will only work with a registered copy of ClickPad II. The current version only works with ClickPad II versions 2.1 and 2.2.x. Future versions will be backward-compatible (to the extent that that is possible).
